<!DOCTYPE html>
<html>
<head>
  <meta charset="utf-8">
  
  <meta http-equiv="X-UA-Compatible" content="IE=edge" >
  <title>微信高性能通用key-value组件MMKV | Grx Blog</title>
  <meta name="viewport" content="width=device-width, initial-scale=1, maximum-scale=1">
  <meta name="description" content="微信高性能通用key-value组件MMKV腾讯微信团队于2018年9月底宣布开源 MMKV ，这是基于 mmap 内存映射的 key-value 组件，底层序列化/反序列化使用 protobuf 实现，主打高性能和稳定性。近期也已移植到 Android 平台，一并对外开源。">
<meta property="og:type" content="article">
<meta property="og:title" content="微信高性能通用key-value组件MMKV">
<meta property="og:url" content="http://yoursite.com/2018/09/25/微信高性能通用key-value组件MMKV/index.html">
<meta property="og:site_name" content="Grx Blog">
<meta property="og:description" content="微信高性能通用key-value组件MMKV腾讯微信团队于2018年9月底宣布开源 MMKV ，这是基于 mmap 内存映射的 key-value 组件，底层序列化/反序列化使用 protobuf 实现，主打高性能和稳定性。近期也已移植到 Android 平台，一并对外开源。">
<meta property="og:updated_time" content="2018-09-26T02:24:38.002Z">
<meta name="twitter:card" content="summary">
<meta name="twitter:title" content="微信高性能通用key-value组件MMKV">
<meta name="twitter:description" content="微信高性能通用key-value组件MMKV腾讯微信团队于2018年9月底宣布开源 MMKV ，这是基于 mmap 内存映射的 key-value 组件，底层序列化/反序列化使用 protobuf 实现，主打高性能和稳定性。近期也已移植到 Android 平台，一并对外开源。">
  
    <link rel="alternative" href="/atom.xml" title="Grx Blog" type="application/atom+xml">
  
  
    <link rel="icon" href="/favicon.png">
  
  <link rel="stylesheet" href="/css/style.css">
</head>

<body>
  <div id="container">
    <div class="left-col">
    <div class="overlay"></div>
<div class="intrude-less">
	<header id="header" class="inner">
		<a href="/" class="profilepic">
			
			<img lazy-src="/img/rufei.jpg" class="js-avatar">
			
		</a>

		<hgroup>
		  <h1 class="header-author"><a href="/">Grx</a></h1>
		</hgroup>

		
		<p class="header-subtitle">自我管理，知识管理，时间管理，阅读，语音写作，思维导图</p>
		

		
			<div class="switch-btn">
				<div class="icon">
					<div class="icon-ctn">
						<div class="icon-wrap icon-house" data-idx="0">
							<div class="birdhouse"></div>
							<div class="birdhouse_holes"></div>
						</div>
						<div class="icon-wrap icon-ribbon hide" data-idx="1">
							<div class="ribbon"></div>
						</div>
						
						<div class="icon-wrap icon-link hide" data-idx="2">
							<div class="loopback_l"></div>
							<div class="loopback_r"></div>
						</div>
						
						
						<div class="icon-wrap icon-me hide" data-idx="3">
							<div class="user"></div>
							<div class="shoulder"></div>
						</div>
						
					</div>
					
				</div>
				<div class="tips-box hide">
					<div class="tips-arrow"></div>
					<ul class="tips-inner">
						<li>菜单</li>
						<li>标签</li>
						
						<li>友情链接</li>
						
						
						<li>关于我</li>
						
					</ul>
				</div>
			</div>
		

		<div class="switch-area">
			<div class="switch-wrap">
				<section class="switch-part switch-part1">
					<nav class="header-menu">
						<ul>
						
							<li><a href="/">主页</a></li>
				        
							<li><a href="/tags/life">随笔</a></li>
				        
							<li><a href="/archives">所有文章</a></li>
				        
						</ul>
					</nav>
					<nav class="header-nav">
						<div class="social">
							
								<a class="github" target="_blank" href="https://github.com/ruixiaoguo" title="github">github</a>
					        
								<a class="weibo" target="_blank" href="https://weibo.com/u/3984935859?refer_flag=1005055010_" title="weibo">weibo</a>
					        
								<a class="rss" target="_blank" href="#" title="rss">rss</a>
					        
								<a class="zhihu" target="_blank" href="#" title="zhihu">zhihu</a>
					        
						</div>
					</nav>
				</section>
				
				
				<section class="switch-part switch-part2">
					<div class="widget tagcloud" id="js-tagcloud">
						<a href="/tags/OC/" style="font-size: 10px;">-OC</a> <a href="/tags/Android/" style="font-size: 10px;">Android</a> <a href="/tags/Apple-Watch/" style="font-size: 10px;">Apple Watch</a> <a href="/tags/Flutter/" style="font-size: 13.33px;">Flutter</a> <a href="/tags/Life/" style="font-size: 10px;">Life</a> <a href="/tags/Lottie/" style="font-size: 10px;">Lottie</a> <a href="/tags/MMKV/" style="font-size: 10px;">MMKV</a> <a href="/tags/MonkeyKing/" style="font-size: 10px;">MonkeyKing</a> <a href="/tags/OC/" style="font-size: 20px;">OC</a> <a href="/tags/RAC/" style="font-size: 11.67px;">RAC</a> <a href="/tags/Swift/" style="font-size: 15px;">Swift</a> <a href="/tags/WKWebView/" style="font-size: 10px;">WKWebView</a> <a href="/tags/WebView/" style="font-size: 10px;">WebView</a> <a href="/tags/Xcode/" style="font-size: 18.33px;">Xcode</a> <a href="/tags/appledoc/" style="font-size: 10px;">appledoc</a> <a href="/tags/hexo/" style="font-size: 11.67px;">hexo</a> <a href="/tags/ios/" style="font-size: 10px;">ios</a> <a href="/tags/life/" style="font-size: 16.67px;">life</a> <a href="/tags/xcode/" style="font-size: 10px;">xcode</a>
					</div>
				</section>
				
				
				
				<section class="switch-part switch-part3">
					<div id="js-friends">
					
			          <a target="_blank" class="main-nav-link switch-friends-link" href="http://blog.devtang.com">唐巧的博客</a>
			        
			          <a target="_blank" class="main-nav-link switch-friends-link" href="http://beyondvincent.com">破船之家</a>
			        
			          <a target="_blank" class="main-nav-link switch-friends-link" href="http://limboy.me">无网不剩</a>
			        
			          <a target="_blank" class="main-nav-link switch-friends-link" href="http://msching.github.io">码农人生</a>
			        
			          <a target="_blank" class="main-nav-link switch-friends-link" href="http://yulingtianxia.com">玉令天下</a>
			        
			          <a target="_blank" class="main-nav-link switch-friends-link" href="http://blog.leichunfeng.com">雷纯锋的技术博客</a>
			        
			          <a target="_blank" class="main-nav-link switch-friends-link" href="http://jax.cnblogs.com">包建强</a>
			        
			          <a target="_blank" class="main-nav-link switch-friends-link" href="http://blog.cnbang.net">bang</a>
			        
			        </div>
				</section>
				

				
				
				<section class="switch-part switch-part4">
				
					<div id="js-aboutme">知识管理，时间管理，自我管理，阅读，语音写作，思维导图，Wiz，TimeMeter</div>
				</section>
				
			</div>
		</div>
	</header>				
</div>

    </div>
    <div class="mid-col">
      <nav id="mobile-nav">
  	<div class="overlay">
  		<div class="slider-trigger"></div>
  		<h1 class="header-author js-mobile-header hide">Grx</h1>
  	</div>
	<div class="intrude-less">
		<header id="header" class="inner">
			<div class="profilepic">
			
				<img lazy-src="/img/rufei.jpg" class="js-avatar">
			
			</div>
			<hgroup>
			  <h1 class="header-author">Grx</h1>
			</hgroup>
			
			<p class="header-subtitle">自我管理，知识管理，时间管理，阅读，语音写作，思维导图</p>
			
			<nav class="header-menu">
				<ul>
				
					<li><a href="/">主页</a></li>
		        
					<li><a href="/tags/life">随笔</a></li>
		        
					<li><a href="/archives">所有文章</a></li>
		        
		        <div class="clearfix"></div>
				</ul>
			</nav>
			<nav class="header-nav">
				<div class="social">
					
						<a class="github" target="_blank" href="https://github.com/ruixiaoguo" title="github">github</a>
			        
						<a class="weibo" target="_blank" href="https://weibo.com/u/3984935859?refer_flag=1005055010_" title="weibo">weibo</a>
			        
						<a class="rss" target="_blank" href="#" title="rss">rss</a>
			        
						<a class="zhihu" target="_blank" href="#" title="zhihu">zhihu</a>
			        
				</div>
			</nav>
		</header>				
	</div>
</nav>

      <div class="body-wrap"><article id="post-微信高性能通用key-value组件MMKV" class="article article-type-post" itemscope itemprop="blogPost">
  
    <div class="article-meta">
      <a href="/2018/09/25/微信高性能通用key-value组件MMKV/" class="article-date">
  	<time datetime="2018-09-25T10:28:47.000Z" itemprop="datePublished">2018-09-25</time>
</a>
    </div>
  
  <div class="article-inner">
    
      <input type="hidden" class="isFancy" />
    
    
      <header class="article-header">
        
  
    <h1 class="article-title" itemprop="name">
      微信高性能通用key-value组件MMKV
    </h1>
  

      </header>
      
      <div class="article-info article-info-post">
        
	<div class="article-tag tagcloud">
		<ul class="article-tag-list"><li class="article-tag-list-item"><a class="article-tag-list-link" href="/tags/MMKV/">MMKV</a></li></ul>
	</div>

        

        <div class="clearfix"></div>
      </div>
      
    
    <div class="article-entry" itemprop="articleBody">
      
        <h1 id="微信高性能通用key-value组件MMKV"><a href="#微信高性能通用key-value组件MMKV" class="headerlink" title="微信高性能通用key-value组件MMKV"></a>微信高性能通用key-value组件MMKV</h1><p>腾讯微信团队于2018年9月底宣布开源 MMKV ，这是基于 mmap 内存映射的 key-value 组件，底层序列化/反序列化使用 protobuf 实现，主打高性能和稳定性。近期也已移植到 Android 平台，一并对外开源。<br><a id="more"></a></p>
<h2 id="1、MMKV简介"><a href="#1、MMKV简介" class="headerlink" title="1、MMKV简介"></a>1、MMKV简介</h2><p>MMKV 是基于 mmap 内存映射的 key-value 组件，底层序列化/反序列化使用 protobuf 实现，性能高，稳定性强。从 2015 年中至今，在 iOS 微信上使用已有近 3 年，其性能和稳定性经过了时间的验证。近期也已移植到 Android 平台，一并开源。</p>
<blockquote>
<p>MMKV最新源码托管地址：<a href="https://github.com/Tencent/MMKV" target="_blank" rel="external">https://github.com/Tencent/MMKV</a></p>
</blockquote>
<h2 id="2、MMKV-源起"><a href="#2、MMKV-源起" class="headerlink" title="2、MMKV 源起"></a>2、MMKV 源起</h2><p>在微信客户端的日常运营中，时不时就会爆发特殊文字引起系统的 crash（请参见文章：《微信团队分享：iOS版微信是如何防止特殊字符导致的炸群、APP崩溃的？》、《微信团队分享：iOS版微信的高性能通用key-value组件技术实践》），文章里面设计的技术方案是在关键代码前后进行计数器的加减，通过检查计数器的异常，来发现引起闪退的异常文字。在会话列表、会话界面等有大量 cell 的地方，希望新加的计时器不会影响滑动性能；另外这些计数器还要永久存储下来——因为闪退随时可能发生。</p>
<p>这就需要一个性能非常高的通用 key-value 存储组件，我们考察了 SharedPreferences、NSUserDefaults、SQLite 等常见组件，发现都没能满足如此苛刻的性能要求。考虑到这个防 crash 方案最主要的诉求还是实时写入，而 mmap 内存映射文件刚好满足这种需求，我们尝试通过它来实现一套 key-value 组件。</p>
<h2 id="3、MMKV-原理"><a href="#3、MMKV-原理" class="headerlink" title="3、MMKV 原理"></a>3、MMKV 原理</h2><ul>
<li>内存准备：</li>
</ul>
<p>通过 mmap 内存映射文件，提供一段可供随时写入的内存块，App 只管往里面写数据，由操作系统负责将内存回写到文件，不必担心 crash 导致数据丢失。</p>
<ul>
<li>数据组织：</li>
</ul>
<p>数据序列化方面我们选用 protobuf 协议，pb 在性能和空间占用上都有不错的表现。</p>
<ul>
<li>写入优化：</li>
</ul>
<p>考虑到主要使用场景是频繁地进行写入更新，我们需要有增量更新的能力。我们考虑将增量 kv 对象序列化后，append 到内存末尾。</p>
<ul>
<li>空间增长：</li>
</ul>
<p>使用 append 实现增量更新带来了一个新的问题，就是不断 append 的话，文件大小会增长得不可控。我们需要在性能和空间上做个折中。</p>
<p>更详细的设计原理参考MMKV 原理。</p>
<h2 id="4、iOS-指南"><a href="#4、iOS-指南" class="headerlink" title="4、iOS 指南"></a>4、iOS 指南</h2><ul>
<li><p>安装引入（推荐使用 CocoaPods）：</p>
</li>
<li><p>安装CocoaPods；</p>
</li>
<li><p>打开命令行,cd到你的项目工程目录, 输入pod repo update让 CocoaPods 感知最新的 MMKV 版本；</p>
</li>
<li><p>打开 Podfile, 添加pod ‘MMKV’到你的 app target 里面；</p>
</li>
<li><p>在命令行输入pod install；</p>
</li>
<li><p>用 Xcode 打开由 CocoaPods 自动生成的.xcworkspace文件；</p>
</li>
<li><p>添加头文件#import <mmkv mmkv.h="">，就可以愉快地开始你的 MMKV 之旅了。</mmkv></p>
</li>
</ul>
<h2 id="更多安装指引参考iOS-Setup。"><a href="#更多安装指引参考iOS-Setup。" class="headerlink" title="更多安装指引参考iOS Setup。"></a>更多安装指引参考iOS Setup。</h2><h2 id="快速上手："><a href="#快速上手：" class="headerlink" title="快速上手："></a>快速上手：</h2><p>MMKV 的使用非常简单，无需任何配置，所有变更立马生效，无需调用synchronize:</p>
<pre><code>MMKV *mmkv = [MMKV defaultMMKV]; 

[mmkvsetBool:YESforKey:@&quot;bool&quot;];BOOL bValue = 

[mmkvgetBoolForKey:@&quot;bool&quot;];

[mmkvsetInt32:-1024forKey:@&quot;int32&quot;];int32_t iValue = 

[mmkvgetInt32ForKey:@&quot;int32&quot;];    

[mmkvsetObject:@&quot;hello, 

mmkv&quot;forKey:@&quot;string&quot;];NSString *str = 

[mmkvgetObjectOfClass:NSString.classforKey:@&quot;string&quot;];
</code></pre><blockquote>
<p> 更详细的使用教程参考iOS Tutorial。</p>
</blockquote>
<ul>
<li>性能对比：</li>
</ul>
<p>循环写入随机的int1w 次，我们有如下性能对比：</p>
<p>更详细的性能对比参考iOS Benchmark。</p>
<h2 id="5、Android-指南"><a href="#5、Android-指南" class="headerlink" title="5、Android 指南"></a>5、Android 指南</h2><ul>
<li><p>安装引入：</p>
</li>
<li><p>推荐使用 Maven：</p>
<pre><code>dependencies{implementation&apos;com.tencent:mmkv:1.0.10&apos;// replace&quot;1.0.10&quot;with any available version}
</code></pre></li>
</ul>
<p>更多安装指引参考Android Setup。</p>
<h2 id="快速上手：-1"><a href="#快速上手：-1" class="headerlink" title="快速上手："></a>快速上手：</h2><p>MMKV 的使用非常简单，所有变更立马生效，无需调用sync、apply。 在 App 启动时初始化 MMKV，设定 MMKV 的根目录（files/mmkv/），例如在 MainActivity 里：</p>
<pre><code>protectedvoidonCreate(Bundle savedInstanceState){super.onCreate(savedInstanceState);    String rootDir = MMKV.initialize(this);    System.out.println(&quot;mmkv root: &quot;+ rootDir);//……}
</code></pre><p>MMKV 提供一个全局的实例，可以直接使用：</p>
<pre><code>importcom.tencent.mmkv.MMKV;//……MMKV kv = MMKV.defaultMMKV();kv.encode(&quot;bool&quot;,true);booleanbValue = kv.decodeBool(&quot;bool&quot;);kv.encode(&quot;int&quot;, Integer.MIN_VALUE);intiValue = kv.decodeInt(&quot;int&quot;);kv.encode(&quot;string&quot;,&quot;Hello from mmkv&quot;);String str = kv.decodeString(&quot;string&quot;);
</code></pre><h2 id="MMKV-支持多进程访问，更详细的用法参考Android-Tutorial。"><a href="#MMKV-支持多进程访问，更详细的用法参考Android-Tutorial。" class="headerlink" title="MMKV 支持多进程访问，更详细的用法参考Android Tutorial。"></a>MMKV 支持多进程访问，更详细的用法参考Android Tutorial。</h2><ul>
<li>性能对比：</li>
</ul>
<p>循环写入随机的int1k 次，我们有如下性能对比：</p>
<p>更详细的性能对比参考Android Benchmark。</p>

      
    </div>
    
  </div>
  
    
<nav id="article-nav">
  
    <a href="/2018/10/10/WKWebView离线缓存/" id="article-nav-newer" class="article-nav-link-wrap">
      <strong class="article-nav-caption"><</strong>
      <div class="article-nav-title">
        
          WKWebView离线缓存
        
      </div>
    </a>
  
  
    <a href="/2018/09/20/LLDebugTool - 便捷的IOS调试工具(支持Swift)/" id="article-nav-older" class="article-nav-link-wrap">
      <div class="article-nav-title">LLDebugTool - 便捷的IOS调试工具(支持Swift)</div>
      <strong class="article-nav-caption">></strong>
    </a>
  
</nav>

  
</article>


<div class="share_jia">
	<!-- JiaThis Button BEGIN -->
	<div class="jiathis_style">
		<span class="jiathis_txt">Share to: &nbsp; </span>
		<a class="jiathis_button_facebook"></a> 
    <a class="jiathis_button_twitter"></a>
    <a class="jiathis_button_plus"></a> 
    <a class="jiathis_button_tsina"></a>
		<a class="jiathis_button_cqq"></a>
		<a class="jiathis_button_douban"></a>
		<a class="jiathis_button_weixin"></a>
		<a class="jiathis_button_tumblr"></a>
    <a href="http://www.jiathis.com/share" class="jiathis jiathis_txt jtico jtico_jiathis" target="_blank"></a>
	</div>
	<script type="text/javascript" src="http://v3.jiathis.com/code/jia.js?uid=1405949716054953" charset="utf-8"></script>
	<!-- JiaThis Button END -->
</div>






<div class="duoshuo">
	<!-- 多说评论框 start -->
	<div class="ds-thread" data-thread-key="微信高性能通用key-value组件MMKV" data-title="微信高性能通用key-value组件MMKV" data-url="http://yoursite.com/2018/09/25/微信高性能通用key-value组件MMKV/"></div>
	<!-- 多说评论框 end -->
	<!-- 多说公共JS代码 start (一个网页只需插入一次) -->
	<script type="text/javascript">
	var duoshuoQuery = {short_name:"true"};
	(function() {
		var ds = document.createElement('script');
		ds.type = 'text/javascript';ds.async = true;
		ds.src = (document.location.protocol == 'https:' ? 'https:' : 'http:') + '//static.duoshuo.com/embed.js';
		ds.charset = 'UTF-8';
		(document.getElementsByTagName('head')[0] 
		 || document.getElementsByTagName('body')[0]).appendChild(ds);
	})();
	</script>
	<!-- 多说公共JS代码 end -->
</div>




</div>
      <footer id="footer">
  <div class="outer">
    <div id="footer-info">
    	<div class="footer-left">
    		&copy; 2019 Grx
    	</div>
      	<div class="footer-right">
      		<a href="http://hexo.io/" target="_blank">Hexo</a>  Theme <a href="https://github.com/litten/hexo-theme-yilia" target="_blank">Yilia</a> by Litten
      	</div>
    </div>
  </div>
</footer>
    </div>
    
  <link rel="stylesheet" href="/fancybox/jquery.fancybox.css">


<script>
	var yiliaConfig = {
		fancybox: true,
		mathjax: true,
		animate: true,
		isHome: false,
		isPost: true,
		isArchive: false,
		isTag: false,
		isCategory: false,
		open_in_new: false
	}
</script>
<script src="http://7.url.cn/edu/jslib/comb/require-2.1.6,jquery-1.9.1.min.js"></script>
<script src="/js/main.js"></script>






<script type="text/x-mathjax-config">
MathJax.Hub.Config({
    tex2jax: {
        inlineMath: [ ['$','$'], ["\\(","\\)"]  ],
        processEscapes: true,
        skipTags: ['script', 'noscript', 'style', 'textarea', 'pre', 'code']
    }
});

MathJax.Hub.Queue(function() {
    var all = MathJax.Hub.getAllJax(), i;
    for(i=0; i < all.length; i += 1) {
        all[i].SourceElement().parentNode.className += ' has-jax';                 
    }       
});
</script>

<script type="text/javascript" src="http://cdn.mathjax.org/mathjax/latest/MathJax.js?config=TeX-AMS-MML_HTMLorMML">
</script>


  </div>
</body>
</html>